home *** CD-ROM | disk | FTP | other *** search
/ Aminet 43 / Aminet 43 (2001)(GTI - Schatztruhe)[!][Jun 2001].iso / Aminet / util / arc / CheckX.readme < prev    next >
Encoding:
Text File  |  2001-05-03  |  8.5 KB  |  182 lines
  1. Short:    V1.84 Check for Archives/Packers/Viruses
  2. Author:   stoecker@epost.de (Dirk Stoecker)
  3. Uploader: stoecker@epost.de (Dirk Stoecker)
  4. Type:     util/arc
  5. Requires: util/arc/xadmaster.lha
  6.  
  7.           util/pack/xfdmaster.lha
  8.           util/virus/xvslibrary.lha
  9.           util/pack/xpk_User.lha
  10. Version:  1.84
  11.  
  12. This program uses xfdmaster.library (see util/pack/xfdmaster.lha) and
  13. xvs.library (util/virus/xvsLibrary.lha) for packer and virus scanning.
  14. The xadmaster.library (see util/arc/xadmaster.lha) is used to dearchive
  15. file and disk archives.
  16.  
  17. The xfdmaster.library (V39) and xadmaster.library (V10) are needed to
  18. run the utility. The xvs.library is recommended! The xpkmaster.library
  19. is needed with ASKPWD password only (and to decrunch XPKF files).
  20.  
  21. NOTE: xadmaster.library is Shareware, so think about registering when
  22. using this utility. See conditions in xadmaster.library distribution.
  23.  
  24. CheckX unpacks archives and packed files as deep as possible:
  25.  - you can unarchive a crunched archive as well
  26.  - multiple crunched files can be decrunched
  27.  - multiple archives can be extracted
  28.  - multiple disk archives can be extracted
  29.  - linked and crunched and archived files are no problem
  30.  
  31. This all depends mainly on your memory size! If have around 50MB and have
  32. only little problems with really large files.
  33.  
  34. Call CheckX with a ? and you get following argument list:
  35.  FROM,LOG,SAVE/K,ALL/S,ASKPWD/S,PRINTALL/S,PRINTEXEC/S,
  36.  NODECRUNCH/S,NOUNLINK/S,NOUNARCHIVE/S,NOUNTRACK/S,NOSILENT/S,
  37.  NOSTRIP/S,NOVIRUS/S,DEBUG/S,QUIET/S,SAVEALL/S
  38.  
  39. Enter a ? again and you get a short doc:
  40.  FROM        source file or directory - may contain patterns
  41.  LOG         log file name
  42.  SAVE        directory, where decrunched files are saved
  43.  ALL         scan deep into directories
  44.  ASKPWD      ask for password when needed (needs xpkmaster.library)
  45.  PRINTALL    print all filenames
  46.  PRINTEXEC   print names of all executable files
  47.  NODECRUNCH  do not decrunch files with xfdmaster
  48.  NOUNLINK    do not unlink files with xfdmaster
  49.  NOUNARCHIVE do not call archiver for unarchiving file archives
  50.  NOUNTRACK   do not call archiver for unarchiving track archives
  51.  NOSILENT    do not disable dos requests
  52.  NOSTRIP     do not strip useless hunks
  53.  NOVIRUS     do not scan with xvs.library for viruses
  54.  DEBUG       also output texts to serial debug engine
  55.  QUIET       do not output texts to console
  56.  SAVEALL     saves all files (also uncrunched) except address files
  57.  
  58. A bit more explanation:
  59. LOG         The output is written to a file as well as to the standard
  60.             output stream. The main purpose CheckX was written for is
  61.             to scan for crunched files and to test the decrunch
  62.             routines. So the logging may take some more time, but is
  63.             very stable, as the last log-entry is always the file which
  64.             possibly crashed the machine.
  65.             The logfile can be accessed by other programs for read and write
  66.             the whole time CheckX works (and surely after that). But writing
  67.             is not recommended, as this may produce a corrupted file.
  68. SAVE        If this keyword is given, all uncrunched/unlinked/stripped
  69.             files will be saved in the directory given with that keyword.
  70.             The directory must already exist! Sub directories are created
  71.             automatically.
  72.             If files are unlinked, they get saved with .1, .2, ...
  73.             extensions. Address crunched files are not saved. Use
  74.             xfdDecrunchAddr or xfdDecrunch to do so.
  75. DEBUG       Should not be used normally. This brings the normal output to
  76.             serial debugging terminal or catcher tools like Sushi. This
  77.             allows a lot easier to detect files producing hits.
  78. ASKPWD      Calls the xpkmaster.library password request to get a password.
  79.             For archive files, the password is asked after first decrunching
  80.             it and getting an password error. The inserted password is reused
  81.             for next entries of this archive and only if it is wrong it is
  82.             again requested.
  83.  
  84. CheckX has following return values:
  85.  0  - all ok
  86.  5  - either no virus checking possible or virus found
  87.  20 - an error occured and CheckX was unable to do anything
  88.  
  89. CheckX cannot scan files, which are read-protected. You get CheckX error 4
  90. as result in that case. Unprotect files and scan again when you want. For
  91. files contained in archives, the protection bits are ignored.
  92.  
  93. CheckX is completely reentrant and may work fine twice or more times
  94. parallel (You can set the pure file protection bit and make it resident).
  95. But it is not recommended to call it multiple times as CheckX normally needs
  96. lots of memory.
  97.  
  98. This is a batch tool, so drink a coffee or two or three during its work.
  99. Check the logfile afterwards. Use a text-editor and scan case sensitive
  100. for "-Virus" and you get lines which are related to viruses (and mostly
  101. only the important lines). A scan with "XFD-", "XAD-", "CheckX-" or
  102. "-Error" brings lines which produced errors.
  103.  
  104. The complete number of found viruses is logged at the file end, if the
  105. scan found some of them. Also the scan time and the number of errors
  106. (if some appeared) is logged.
  107.  
  108. If the permanent file scrolling slows down your computer try setting the
  109. output stream to a raw mode display using following redirect command:
  110. ">RAW:0/11/640/50/CheckX-Output/AUTO/CLOSE/WAIT".
  111. To get CheckX really silent either use LOG option and call CheckX with
  112. QUIET or redirect normal output into logfile with ">filename".
  113.  
  114. CheckX detects all the viruses found by xvs.library, which contains the
  115. complete antivirus knowledge of VirusZ utility by Georg Hörmann. CheckX
  116. cannot remove detected viruses. You still need antivirus software like
  117. VirusZ, VT or Virus_Checker. I always run VirusZ in the background to
  118. check for viruses.
  119. CheckX also scans disk archive information texts for packers and viruses
  120. and also bootsectors of dearchived disks. The memory is scanned once after
  121. starting CheckX.
  122.  
  123. Error 11 (Could not check for virus) mostly means, that the file is a bit
  124. to large and such files are normally archives only. So in most cases this
  125. error is harmless!
  126.  
  127. If there are serious errors, please report them, but CheckX has a long
  128. way of development and I hope it is really stable now.
  129. Send me files, which cause the system to bring Enforcer/MungWall/PatchWork
  130. hits or crash the computer. If the files are larger, please contact me
  131. first.
  132.  
  133. This program is Freeware. Use it as you want, but WITHOUT ANY WARRANTY!
  134.  
  135. Contact me at:
  136.  
  137. *********************************************************************
  138. * snail-mail:                  * e-mail:                            *
  139. *   Dirk Stoecker              *   stoecker@epost.de                *
  140. *   Geschwister-Scholl-Str. 10 *   dirk@dstoecker.de                *
  141. *   01877 Bischofswerda        * world wide web:                    *
  142. *   GERMANY                    *   http://www.dstoecker.de/         *
  143. * phone:                       * pgp key:                           *
  144. *   GERMANY +49 (0)3594/706666 *   get from WWW pages or keyservers *
  145. *********************************************************************
  146.  
  147. Following is my PGP signature for the corresponding LhA-File.
  148. Use ' pgpv CheckX.readme -o CheckX.lha ' to check it.
  149. Key fingerprint: B9 F2 3A 1A 29 02 75 16  6A C6 5B 7D 5E F6 16 CF.
  150. All my releases after April 2001 have a PGP signature with this key.
  151. Be alarmed if signature is missing or wrong.
  152.  
  153. -----BEGIN PGP SIGNATURE-----
  154. Version: PGPfreeware 5.0i for non-commercial use
  155. MessageID: 2Hb16l1zObyBoj8+ujy+KN3O2xVF4Njp
  156.  
  157. iQCVAwUAOt3XJ7OTsAT/iOY9AQF10gP/UXZJhR2UgatF7bGzMH7RRhEzcoYOpx3+
  158. 9hzJDX2AUg+QDtb7OD5ntwcoiJAH5Y2xa5dL2sRuEbCYkB+8JQbcV6zfUcurjbuj
  159. mnLsdx4uIpXmLuJSOw0dvzpKv37qdtv5JshJFQQwfooZhlc6A1ARBw6EZcz1TQxG
  160. iyZILEmy9xk=
  161. =2iTj
  162. -----END PGP SIGNATURE-----
  163.  
  164.  
  165. ============================= Archive contents =============================
  166.  
  167. Original  Packed Ratio    Date     Time    Name
  168. -------- ------- ----- --------- --------  -------------
  169.     2146    1519 29.2% 18-Apr-01 20:03:34  CheckX.info
  170.    11268    6424 42.9% 18-Apr-01 20:03:34 +CheckX
  171.     7138    2991 58.0% 18-Apr-01 20:03:34 +CheckX.readme
  172.    48048   13882 71.1% 18-Apr-01 20:03:34 +CheckX.c
  173.     2188     805 63.2% 18-Apr-01 20:03:34 +SDI_ASM_STD_functions.lib
  174.     5603    1970 64.8% 18-Apr-01 20:03:34 +SDI_ASM_STD_protos.h
  175.     1743     646 62.9% 18-Apr-01 20:03:34 +SDI_compiler.h
  176.     1257     550 56.2% 18-Apr-01 20:03:34 +SDI_version.h
  177.      400     266 33.5% 18-Apr-01 20:03:34 +SMakeFile
  178.     1453     732 49.6% 18-Apr-01 20:03:34 +StartCode.a
  179.      192     169 11.9% 18-Apr-01 20:03:34 +StartCode.o
  180. -------- ------- ----- --------- --------
  181.    81436   29954 63.2% 18-Apr-101 21:14:28   11 files
  182.